Search Templates

A Search Template lets you store search queries with placeholders. During runtime, you can replace the placeholders defined in the search template with actual keywords. Refer to the Search Templates section in LogPoint for more details.

Using LPSM, you can create, manage, and perform actions on search templates on behalf of the Fabric-enabled LogPoint.

Note

You can create, edit, and perform actions on search templates on LogPoint v6.10.0 and later only. However, you can share a search template to different user groups with Read, Edit, or Full permissions on LogPoint v6.12.0 and later only, and you can push search templates and view push history on LogPoint v7.0.0 and later only.

Adding a Search Template

  1. Go to Settings >> LogPoint Configuration >> Search Templates.

    ../_images/LPSM_KB_ST_Add.png

    Search Templates

  2. Click Add.

    ../_images/LPSM_KB_ST_AddPanel.png

    Adding a Search Template

  3. Select a Pool, a Machine, and a LogPoint User.

  4. Enter a Name and a Description.

  5. Enter a basequery name and a query.

    Note

    • Use {{ and }} to enclose placeholders in the queries.

    • Click the Plus icon to add new base queries and the Minus icon to remove a field.

  6. In the Fields section, enter a Field which is a placeholder used in a base query, a Display Text for the field, and a default Value.

    Note

    You can provide multiple values for Field, Display Text, and Value.

  7. Click Submit.

Note

Click the ? icon near the top-right corner to get help on the inputs.

Pushing Search Templates

  1. Go to Settings >> LogPoint Configuration >> Search Templates.

  2. Select the search templates and click Push.

    ../_images/LPSM_KB_ST_Push.png

    Pushing a Search Template

    ../_images/LPSM_KB_ST_PushDetails.png

    Push Search Templates

  3. Select the Pool, LogPoint, or User where you want to push the selected search templates.

  4. Click Push.

Push History

You can click the Push History button to check the push history.

../_images/LPSM_KB_ST_PushHistory.png

Push History

The Push History page lists the Push Summary, Status, Date, and Actions of all push attempts.

Click the Retry (retry) icon from the Actions column to retry the failed push attempt.

Click the Details (details) icon from the Actions column to open the Push Detail page.

Editing a Search Template

  1. Go to Settings >> LogPoint Configuration >> Search Templates.

  2. Click the Edit icon from the Actions column of the search template.

../_images/LPSM_KB_ST_Edit.png

Editing a Search Template

  1. Update the information.

  2. Click Submit.

Sharing Search Templates

You can share a search template with all the users in the system and give them the read, edit, or full permissions. Any changes made in the search templates are visible to all the shared users.

Each parameter in a shared search template is categorized into three types:

  1. Global parameters can be changed only by the users with the Edit or Full permissions. Changes in the global parameters are reflected for all the users using the shared search template. The following parameters are global:

    • The name, description, queries, and field values of the search template.

    • Title and order of tabs, including creation and deletion of tabs.

    • Title, query, dimensions, and positions of widgets, including addition and deletion of widgets.

  2. Personalized parameters can be changed by all the users. However, the changes in the personalized parameters are reflected only for the users making the change. The following parameters are personalized:

    • The updatable parameters

    • Selected repos

    • Time range

  3. Hybrid parameters can be changed by all the users. If the user changing the parameters has the Edit or Full permissions, the changes are reflected for all the users. However, if the user has only the Read permission, the changes are reflected only for the user making the change. The following parameters are hybrid:

    • Chart types of widgets

    • Legends and legend labels of widgets

    • Trend state of widgets

Note

  • If a user with the Edit or Full permissions changes a hybrid parameter, the changes made by all other users are overridden.

  • A user with the Full permission can also Share and Delete a shared search template.

To share a search template:

  1. Go to Settings >> LogPoint Configuration >> Search Templates.

  2. Click the Share Template icon from the Actions column of the search template.

    ../_images/LPSM_KB_ST_Share.png

    Search Templates

    1. To share multiple search templates, select the search templates. Click the More drop-down and select Share Selected With Other Users.

      ../_images/LPSM_KB_ST_ShareSelected.png

      Share Multiple Search Templates

  3. Select the users groups for all the users you want to share the search templates.

    ../_images/LPSM_KB_ST_ShareSearchTemplate.png

    Providing Permissions for the Shared Search Template

  4. Select the Read, Edit, or Full permissions for the users.

  5. Click Submit.

Note

  • If you delete the owner of the search template from the system, LogPoint provides two options:

    • You can delete the search template as well, making it unavailable to all the users.

    • You can re-assign the search template to any other user in the system.

  • You can unshare a search template by removing the permissions for all the user groups from the Share Search Template panel.

Cloning Search Templates

  1. Go to Settings >> LogPoint Configuration >> Search Templates.

  2. Click the Clone icon from the Actions column of the search template.

    ../_images/LPSM_KB_ST_Clone.png

    Search Templates

  3. Select a LogPoint user from the drop-down.

    ../_images/LPSM_KB_ST_CloneST.png

    Clone Search Template

  4. Enter a new Name for the cloned template.

  5. Select the Replace Existing? checkbox to replace an existing template with the same name.

  6. Click Clone.

Deleting Search Templates

  1. Go to Settings >> LogPoint Configuration >> Search Templates.

  2. Click the Delete icon from the Actions column of the search template.

    ../_images/LPSM_KB_ST_Delete.png

    Search Templates

    1. To delete multiple search templates, select the search templates. Click the More drop-down and select Delete Selected Templates.

      ../_images/LPSM_KB_ST_DeleteSelected.png

      Delete Selected Search Templates

    2. To delete all the search templates, click the More drop-down and select Delete All.

      ../_images/LPSM_KB_ST_DeleteAll.png

      Delete all Search Templates

  3. Click Yes.

Viewing a Search Template

  1. Go to Settings >> LogPoint Configuration >> Search Templates.

  2. Click the Name of the template you want to view.

    ../_images/LPSM_KB_ST_View.png

    Search Templates

    LPSM directs you to the Search Template View where you can access the dashboards of the search template. From the Search Template View, you can perform the following tasks:

Adding a Dashboard

  1. Click the Plus icon at the top.

    ../_images/LPSM_KB_ST_View_AddDash.png

    Add Dashboard

  2. Enter the Dashboard Name.

    ../_images/LPSM_KB_ST_View_AddDashPanel.png

    Add Dashboard Panel

  3. Click Ok.

Note

You must add at least one dashboard to use the features of the Search Template View.

Adding a Widget

  1. Click Add Widget.

    ../_images/LPSM_KB_ST_View_AddWidget.png

    Dashboard

  2. Enter a widget Name.

    ../_images/LPSM_KB_ST_View_CreateWidget.png

    Create Widget Panel

  3. Enter a base Query within {{ and }}.

  4. Enter a Description and a Time-range for the widget.

  5. Click Finish.

Auto Arrange the Widgets

Click Auto Arrange to automatically arrange the widgets in a presentable form.

../_images/LPSM_KB_ST_View_AutoArrange.png

Dashboard

Updating Parameters

  1. Enter the new values for the variables in the Update Parameters section.

../_images/LPSM_KB_ST_View_UpdateParameters.png

Update Parameters Panel

  1. Select Override widget time range to select a time-range. The time-range you provide takes precedence over the one provided for individual widgets.

  2. Select the Repos where you want to perform the search.

  3. Click Update.

Stopping widget update

After clicking Update, the widgets continuously retrieve their respective logs.

Click the Stop button to stop the widgets from retrieving additional logs. Doing this pauses the visualization of all the widgets. You can only see the already received log results.

../_images/LPSM_KB_ST_View_Stop.png

Stop Update

Note

  • The widgets show updated values only after you click the Update button.

  • Click Back to redirect to the list view of the search templates.

  • The search templates remember the last visualization used on the widgets.

  • You can drill-down on the search results from the non-edit mode of the widget of the search templates.


Helpful?

We are glad this guide helped.


Please don't include any personal information in your comment

Contact Support